home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / pmdm109h.zip / README.DOC < prev   
Text File  |  1994-10-21  |  13KB  |  310 lines
  1.   ***TLIB-keywords*** "%n: Version %v at %f"
  2.   "readme.doc: Version 14 at 21-Oct-94,21:20:02"
  3.  
  4.   ***TLIB-revision-history***
  5. * 1 readme.doc 17-Dec-93,22:29:52 PMDMatch 'readme' file
  6. * 2 readme.doc 31-Dec-93,20:33:52 Changes for v1.04
  7. * 3 readme.doc 4-Jan-94,20:47:02 Changes for v1.05
  8. * 4 readme.doc 7-Jan-94,8:02:36 Changes for v1.06
  9. * 5 readme.doc 14-Jan-94,12:15:32 Changes for v1.07
  10. * 6 readme.doc 26-Jan-94,20:23:16 Changes for v1.08
  11. * 7 readme.doc 27-Feb-94,10:52:32 Changes for v1.09
  12. * 8 readme.doc 19-Mar-94,12:30:38 Changes for v1.09b
  13. * 9 readme.doc 21-Apr-94,20:34:20 Changes for v1.09c
  14. * 10 readme.doc 21-May-94,16:23:30 Changes for v1.09d
  15. * 11 readme.doc 18-Jul-94,19:24:58 Changes for v1.09e
  16. * 12 readme.doc 19-Aug-94,18:47:46 Changes for v1.09f
  17. * 13 readme.doc 24-Sep-94,09:41:06 Changes for v1.09g
  18. * 14 readme.doc 21-Oct-94,21:20:02 Changes for v1.09h
  19.   ***TLIB-revision-history***
  20.  
  21. PMDMatch is an OS/2 utility inspired by the DirMatch utility
  22. originally published years ago in PC Magazine.  I use it to
  23. maintain floppy backups of the projects I'm working on by
  24. matching the project directory with the same directory on
  25. the floppy and only having to copy files that are newer.  It
  26. can also be used when merging a software update (by taking
  27. a 'snapshot' before the installation and then comparing
  28. that to the resulting directories afterward), as a file
  29. viewer, and for limited directory management (it is a specific
  30. purpose utility, so don't expect a full-fledged directory
  31. management package, although I have tried to provide as many
  32. features and make it as flexible/configurable as I could).
  33. Just unzip or copy the files to a directory of your choice and
  34. run it from there.
  35.  
  36. NOTE:  PMDMatch is packaged using Info-ZIP's compression utility.
  37. Info-ZIP's software (Zip, UnZip and related utilities) is free
  38. and can be obtained as source code or executables from various
  39. bulletin board services and anonymous-ftp sites, including
  40. CompuServe's IBMPRO forum and ftp.uu.net:/pub/archiving/zip/*.
  41. For your convenience, I have provided a copy of UnZip on this
  42. disk...
  43.  
  44. Probably the best way to run the first time is:
  45.  
  46.   PMDMatch dirpath1 dirpath2
  47.  
  48. This will bring up PMDMatch and compare the two directories.
  49. It will also create an initial 'PMDMatch.ini' file in the
  50. directory from which it was run to hold your personalized
  51. settings such as color, font, options, etc.  The 'dirpath's
  52. can be full or relative specifications with or without drive
  53. letter.  Then take a look through the help contents or index
  54. and learn about the other options and usage.
  55.  
  56. Or you can use the PMDSetup.cmd; just tell it where you put
  57. the PMDMatch.exe when it asks and it will create an object
  58. on the desktop for you. 
  59.  
  60. Then I suggest you go through the 'help' contents and find
  61. all of the things it can do.  You can get context sensitive
  62. help on any item by pressing F1 when it has the focus.
  63.  
  64. Here's the stuff I still intend to (someday <s>) add, based
  65. upon how much demand (and time) there is for them:
  66.  
  67. 1) Add the ability to move/copy to a different target than the
  68.    other container by drag/drop as well as selection when
  69.    confirmation is enabled
  70.  
  71. 2) Add a capability to create the destination directory if
  72.    if doesn't exist
  73.  
  74. 3) Add the ability to choose individual fields such as size,
  75.    date/dime or a combination when comparing for differences
  76.  
  77. 4) Add a mode to only check for files that exist on one directory
  78.    but not in the other
  79.  
  80. 5) Implement full 'drag and drop' to copy/move files
  81.  
  82. 6) Add the ability to choose to have the directory containers
  83.    one on top of the other or side by side as they are now
  84.    (depends upon how many want this)
  85.  
  86. 7) Implement printing (The 'snapshot' file is a comma-
  87.    delimited ASCII text file so you may be able to use
  88.    that in the meantime.)
  89.  
  90. 8) Change the 'options' menu to a notebook control (low
  91.    priority)
  92.  
  93. 9) Change selection directory control to a container and
  94.    allow tree or single level display of directories (low
  95.    priority)
  96.  
  97. 10) Allow direct edit of the container title to change dirs
  98.    (low priority)
  99.  
  100. I try to keep my registered users at least a version
  101. ahead of the one I upload to OS2BVEN, so if you want to be
  102. sure to get the latest, please be sure and register!  The only
  103. difference between this shareware and commercial software is
  104. that you get the chance to try it before you spend your hard-
  105. earned money.  But if you continue to use it, you are obligated
  106. to pay the author for the MANY hundreds of hours that are still
  107. going into its development!
  108.  
  109. Credits:
  110. I'd like to thank my wife Liz for, as she puts it, "getting
  111. to know the back of my head very well" while I've been working
  112. on this program.  I'm also very indebted to Bill Speights for
  113. his help in testing and proof-reading and his wife Sarah for
  114. putting up with us!  And without the answers to those 'undocumented'
  115. container questions by Rick Fishman, none of this would have
  116. been possible!
  117.  
  118. Known Problems:
  119. (I'm working on these, but if I keep waiting until I get them
  120. all fixed, I'll never get the new functions available <g>.)
  121. 1) Sometimes when copying files it will say it can't find the
  122.    file it's trying to copy and a retry then works fine.  I
  123.    haven't gotten it to happen predictably enough to be able
  124.    to track it down in the debugger.
  125. 2) The function keys entries for copy/move/etc.
  126.    should be disabled when a 'snapshot' is loaded.
  127.  
  128. Version History:
  129. 1.09h
  130.     1) Added the ability to turn off showing the progress dialog.
  131.     2) Added the ability to invoke a compare program of the user's
  132.        choice to compare the two files' contents.
  133.     3) Corrected a bug where the 'swap' function wouldn't dismiss
  134.        the progress dialog.
  135.     4) Corrected a bug where the command-line snapshot didn't
  136.        close when finished.
  137.     5) Added the total number of files in each container to the
  138.        statistics dialog box.
  139.  
  140. 1.09g
  141.     1) Added a check to see if the snapshot file exists.
  142.     2) Added the /1 option for displaying just a single
  143.        directory.
  144.     3) Added the ability to capture a snapshot from the
  145.        command line.
  146.     4) Added the ability for the user to put comments in a
  147.        snapshot file.
  148.     5) Better handling of 'same' directory; if the directory
  149.        in the box is also on the drive which gets chosen, leaves
  150.        it there rather than going to root.
  151.     6) Added a conditional cascade menu to the 'mark all' on the
  152.        popup menu so you can specify to 'mark all and copy', etc.
  153.        You can set the default item to be used in the 'mark/clear
  154.        modes' dialog.
  155.     7) Added another column to display the Extended Attributes sizes.
  156.  
  157. 1.09f
  158.     1) Added a dialog box to indicate 'busy/in progress' rather than
  159.        just using the 'alarm clock' pointer.
  160.     2) Added {ahrs} indications of 'archived', 'hidden', 'read-only',
  161.        and/or 'system' files at the end of the file name.
  162.     3) Added an option to control whether the {a}rchived attribute
  163.        is to be indicated or not.
  164.     4) Added an checkbox to the 'filters' dialog to control whether
  165.        or not 'system/hidden' files are included.
  166.     5) Changed so that several threads can be active at a time
  167.        when copying/etc. files to improve performance.
  168.        
  169. 1.09e
  170.     1) Added the ability to specify the name of a file containing
  171.        a list of file names which are the only ones to be shown,
  172.        either with a command line option or the filter dialog box.
  173.     2) Added the ability to include the files in all of the
  174.        subdirectories below the current ones.  Building the lists
  175.        for an entire drive can be time-consuming so use with care.
  176.        It can be turned on from the command line with the /R switch
  177.        or checked on the option menu.  The setting is NOT saved in
  178.        the pmdmatch.ini file.
  179.  
  180.        Because of having added this feature, I found that I needed
  181.        to change the contents of 'snapshot' files so those taken
  182.        with 1.09d will not work.  However, you can manually change
  183.        them to be compatible if you really need to by adding a line
  184.        at the top of the file.  It needs to be the complete drive/
  185.        path specification of the directory that was current when
  186.        the snapshot was taken.  It must be enclosed in double-quotes
  187.        and end with a backslash as in the following example (it does
  188.        not have to be in any particular case-all lower, upper, or
  189.        mixed is fine):
  190.        
  191.        "C:\CUR\DIR\AT\SNAPSHOT\"
  192.  
  193.     3) More minor 'cosmetic' corrections and bug fixes
  194.  
  195. 1.09d
  196.     1) Added the ability to save and load a 'snapshot' list of
  197.        the files selected in a container for use in a comparison-
  198.        only mode
  199.     2) Reduced the button spacing so the buttons can be as large
  200.        as possible so larger text will fit on them
  201.     3) Several other minor 'cosmetic' corrections and bug fixes
  202.  
  203. 1.09c
  204.     1) Corrected a bug which gave a fatal error when trying
  205.        to copy a non-8.3 format filename to a floppy
  206.     2) Moved the 'both', 'same', and 'filters' menu items from
  207.        the 'file' menu to the 'view' menu to be more CUA
  208.        compliant
  209.     3) Corrected a bug where the 'alike' filter mode showed more
  210.        than just 'alike' files
  211.     4) Corrected a bug that prevented the 'ignore read-only'
  212.        from resetting the read-only attribute on the target
  213.  
  214. 1.09b
  215.     1) Added the ability to double-click in the containers
  216.        title areas to bring up the directory selection dialog
  217.        box
  218.     2) Put a directory selection list box into the dialog so
  219.        either or both directories can be chosen at the same
  220.        time
  221.     3) Added the /S option to display the directory selection
  222.        dialog box when first starting up
  223.  
  224. 1.09a
  225.     1) Corrected so 'help' can be found in the directory
  226.        from which the .exe was run, if it's not in the
  227.        'set HELP=' path
  228.     2) Corrected so directory selection list doesn't return
  229.        file names from a Novell network drive
  230.  
  231. 1.09
  232.     1) Made the directory selection dialog box larger (and
  233.        added a horizontal scroll bar) so it would show more
  234.        drives/directories at once
  235.     2) Corrected so the directory selection list box shows
  236.        FAT directories in sorted order
  237.     3) Implemented 'move' option
  238.     4) Added a pop-up menu for the containers
  239.     5) Added an option to show or not show the buttons since
  240.        the popup menu can do all they do
  241.     6) Added a check box to the directory selection dialog box
  242.        to allow showing the entire tree of subdirectories below
  243.        the current level or just the next level (this may be
  244.        replaced with a container tree view control someday)
  245.  
  246. 1.08
  247.     1) Added a /L command line option for specifying 'filter All'
  248.     2) Implemented 'Ignore Read-Only attributes' option
  249.     3) Corrected bugs with using tab/arrow keys to move among
  250.        controls (buttons and containers)
  251.     4) Implemented 'Highlight identical files' option
  252.     5) Changed filter toggle cycling key from F8 to F7
  253.     6) Added a Swap-F8 button.  Note that this will cause the
  254.        customized colors/fonts of the buttons to be lost the first
  255.        time this new version is run and they will have to be setup
  256.        again <sorry>
  257.  
  258. 1.07
  259.     1) Corrected a directories display problem which occurred when
  260.        there was no .ini file and PMDMatch was first run without
  261.        any command line directories
  262.     2) Changed colorization so that the default system colors are
  263.        used until drag/drop has been done to customize them so the
  264.        user doesn't feel they're locked into my arbitrary choice of
  265.        colors
  266.     3) Corrected problems with the directory choices dialog box
  267.  
  268. 1.06
  269.     1) Added 'exclude' filter handling
  270.  
  271. 1.05
  272.     1) Corrected some error message handling problems when one of
  273.        the directories being specified didn't exist
  274.     2) Reworked 'include' filter handling
  275.     3) Enhanced error handling during 'dir'/'drive' selections
  276.     
  277. 1.04
  278.     1) Corrected a problem where closing while still filling the
  279.        containers would report an error by disabling 'close' on
  280.        the system menu
  281.     2) Added 'Abort/Retry/Ignore' to error message/handling
  282.     3) Changed 'About to' messages to be informational instead
  283.        of questions (eliminates beep as well)
  284.     4) Corrected an access violation bug
  285.     5) Added simple animation to the About box
  286.     6) Added 'include' filter handling
  287.     7) Corrected a problem where files which were only different
  288.        in size didn't show up in the different/modified views.
  289.        They now show but neither is high-lighted since it's
  290.        impossible to tell which is 'newer'
  291.  
  292. 1.03
  293.     1) Corrected directory selection so selecting drive letters
  294.        refreshes the directory list
  295.     2) Corrected a bug where double-clicking on an empty container
  296.        window caused an access violation
  297.  
  298. 1.02
  299.     1) Corrected multiple instances problem
  300.     2) Changed directory selection dialog to be common
  301.     3) Corrected 'delete' file 'in-use' emphasis
  302.     4) Corrected a problem when trying to specify just a drive
  303.        on the command-line so it uses that drive's current
  304.        directory
  305. 1.01
  306.     1) Main funtionality complete
  307.  
  308. 1.00
  309.     1) Initial release
  310.